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Description 

BRIEF DESCRIPTION OF THE INVEKHON 

[00011 This inventton relates generally to accessing 
software objects in an object oriented software environ- 
ment. More particularly, this invention relates to a tech- 
nique for reducing the primary memory footprint asso- 
ciated with the process of accessing software objects. 

BACKGROUND OF THE INVENTION 

[0002] Rgure 1 illustrates a computer 20 constructed 
in accordance with the prior art The computer 20 in- 
cludes a central processing unit 22. which communi- 
cates with a set of input/output devices (e.g., keyboard, 
mouse, video monitor, printer, and the like) 24 over a 
system bus 26. Also connected to the system bus is a 
primary memory (e.g., volatile memory, such as a RAM) 
28 and a secondary memory (e.g., mass storage, such 
as a disk) 30. The secondary memory stores a set of 
software objects 32. The software objects 32 are char- 
acterized by an object nst 34. which includes header en- 
tries 36 and a central directory 38, which provides a 
short-hand characterization of the header entries 36. 
[0003] An applteatton program 40 stored in primary 
memory 28 Is executed by the central processing unit 
22 The application program 40 invokes objects 32 to 
perform specified functtons. In particular, the appiteation 
program 40 accesses a primary memory object index 
42, whfch basically corresponds to the object fist central 
directory 38. as discussed betow. The primary memory 
object index 42 allows the applteatton program 40 to 
identify and toad invoked objects 32 stored in secondary 
memory 30. After being invoked, the selected objects 
44 are resident in primary memory 28. 
[0004] Figure 2 illustrates an object list 34 in accord- 
ance with the prtor art The object list 34 Includes a set 
of object list entries 36A-36N. Each entry Includes an 
object name 50. a header 52, and data 54. The header 
52 includes information, such as object verston. general 
purpose bit flags, compresston method Information, a 
cyclto redundancy check of uncompressed data, com- 
pressed data size, uncompressed data size, filename 
length, and the like. The data 54 includes the instmc- 
tions or other infonnatjon associated with the object 
Since each entry 38 can be relatively large, a central 
directory 38 Is associated with the object list 34. The 
central directory includes a set of central directory en- 
tries 48A-48N corresponding to the object list entries 
36A-36N. Each central directory entry 48 Includes an 
object name 50 and a pointer 60 to the location of ttie 
corresponding object fist entry 36. 
[0005] As previously indicated, the primary memory 
object index 42 is typically implemented as the central 
directory 38 of the object list 34. The problem with this 
approach is that the central directory 38 can be relatively 
large because it includes such information as the object 



name, the object's k)cation, and miscellaneous Informa- 
tion about the object It is well known that the perform- 
ance of a computer is largely contingent upon its effi- 
cient use of primary memory. An oversized primary 
5 memory object index can lead to infertor computer per- 
formance. 

[0006] The foregoing problem is more fully appreciat- 
ed in connection with a specific example. JAVA™ Is a 
well known computer language devetoped and ficensed 

10 by Sun Mfcrosystems, Inc., Mountain View. California, 
ttie assignee of the present invention. An application 
program 40 written in JAVA™ Is supported by a large 
object nst. The central directory 38 of the object list 34 
Is scanned through a bootclasspath or application class- 

15 path, resulting in the constructton of the primary memory 
object index 42. The resultant primary memory object 
index 42 is relatively large. 

[0007] The JAVA"~ Development Kit (JDK'^) is an ob- 
ject list 34 whteh contains the software and tools ttiat 
20 developers need to compile, debug, and run applets and 
applteattons written using the JAVA™ programming lan- 
guage. Java Archive (JAR) is a platform-independent 
file format that aggregates many files into one. Multiple 
JAVA™ applets and their requisite components (e.g., . 
25 Class files. Images and sounds) can be bundled in a JAR 
file and subsequentiy downtoaded to a web browser in 
a single Hypertext Transport Protocol (HTTP) transac- 
tion, greatly improving the downtoad speed. The utility 
"java.util.jar provides classes for reading and writing 
30 tiie JAR file format. The JAR file format is based on a 
•ZIP" file format ttiat Is used In JAVA™. The utility "java. 
utlLzip" provWes classes for reading and writing the 
standard ZIP and GZIP file formats. Some of the classes 
associated with 1ava.util.zlp- that are used by -java.util. 
35 jar" include: DeflaterOutputStream, whtoh is a class to 
implement an output stream filter for compressing data 
in the "deflate" compression format; Inflaterlnput- 
Stream, whteh is a class to implement a stream filter for 
uncompressing data in tiie "deflate" compresston for- 
4o mat; ZIpEntry, which Is a class to represent a ZIP file 
entry, ZlpFlle. whfch is a class to read entries from a zip 
file; and ZipException, which is a class to handle ex- 
cepttons. Some of the classes ttiat are used by "java. 
utiLzip" include: checksum, whfch is an interface rep- 
45 resenting a data checksum; CRC32. whfch is a class 
ttiat can be used to compute the thirty-two bit cyclfc re- 
dundancy check of a data stream; and ZIpEntry, which 
IS a class used to represent a ZIP file entry. 
[0008] In JDK 1 .2. for each ZIP or JAR file on the boot- 
50 classpath or applicatton classpath. the file's central di- 
rectory 38 is scanned and a primary memory object in- 
dex 42 is built In the prior art. all of the information from 
tfie central directory 38 Is loaded into primary memory 
28. This Includes the name of the ZIP entry, if s offset in 
55 tfie ZIP file, and about 24 bytes of additional information. 
This results In about 4,500 ZIP entries in a primary mem- 
ory object index 42 that takes up approximately 424 KB. 
This relatively large primary memory footprint is expect- 
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ed to grow as additional classes are added to support 
JAVA^. 

[0009] In view of the foregoing, it would be highly de- 
sirable to provide a technique for loading objects from 
a primary memory index that has a relatively small pri- 
mary memory footprint Such a technique could t>e 
used, for example, to reduce the primary memory foot- 
print of the ZIP index for the core JAVA*^ classes. Such 
a technique could also be used for applications that use 
large JAR files. 

SUMMARY OF THE INVENTION 

[0010] A method of bading objects from primary 
memory includes the step of creating hash values for 
listed objects to create a hash index specifying a set of 
hash values. The hash index Is loaded into primary 
memory to form a primary memory hashed index object 
directory. A calculated hash value is derived for an in- 
voked object. The calculated hash value Is matched with 
a hash value in the primary memory hashed Index object 
directory. In response to this matching operation, an ob- 
ject corresponding to the calculated hash value is load- 
ed Into primary memory. 

[0011] A computer readable medium has an index 
generator with executable Instructions to create hash 
values for listed objects, thereby creating a hash Index 
specifying a set of hash values. The index generator 
loads the hash index Into primeiry memory to form a pri- 
mary memory hashed index object directory. Ah object 
loader has executable instructions to derive a calculated 
hash value for an invoked object. The object bader 
matches the calculated hash value with a hash value in 
the primary memory hashed index object directory. In 
response to a match, the object loader loads into prima- 
ry memory an object corresponding to the cabulated 
hash value. 

[0012] The Inventbn provides a technique for loading 
objects from a primary memory Index that has a rela- 
tively small primary memory footprint. The technique of 
the Inventbn is advantageously used to reduce the pri- 
mary nnemory footprint of the ZIP index for the core 
JAVA"^ classes. The technique can also be exploited 
for applications that use large JAR files. 

BRIEF DESCRIPTION OF THE DRAWINGS 

[0013] For a better understanding of the invention, ref- 
erence should be made to the folbwing detailed descrip- 
tion taken in conjunction with the accompanying draw- 
ings. In which: 

[0014] FIGURE 1 1llustrates a prbr art computer with 
a relatively large primary rr>emory object Index. 
[0015] FIGURE 2 illustrates the form of an object list 
In accordance with the prbr art 

[0016] FIGURE 3 illustrates a computer system with 
a hashed index object directory in accordance with the 
present Invention. 



[001 7] FIGURE 4 illustrates processing steps associ- 
ated with an Index generator constructed in accordance 
with an embodiment of the invention. 
[001 q FIGURE 5 illustrates a hashed Index object d1- 
5 rectory constmcted In accordance with an embodiment 
of the Invention. 

[0019] FIGURE 6 Illustrates an object bader con- 
structed In accordance with an embodiment of the in- 
ventbn. 

10 [0020] FIGURE 7 illustrates a computer system with 
a hashed Index object directory forming a portion of a 
computer network in accordance with an embodiment 
of the invention. 

[0021] Like reference numerals refer to correspond- 
is ing parts throughout the drawings. 

DETAILED DESCRIPTION OF THE INVENTION 

[0022] Figu re 3 illustrates a computer 70 constructed 
20 In accordance with an embodiment of the inventbn. The 
computer 70 Includes many of the components of the 
prbr art computer 20 of Rgure 1 . In particular, the com- 
puter 70 Includes a central processing unit 22, which 
communicates with a set of Input/output devices (e.g., 
25 keyt>oard, mouse, vWeo monitor, printer, and the like) 
24 over a system bus 26. Also connected to the system 
bus 26 Is a primary menrxsry (e.g., volatile memory, such 
as a RAM) 28 and a secondary memory (e.g., mass stor- 
age, such as a disk) 30. The secondary memory 30 
30 stores a set of software objects 32. The software objects 
32 are characterized by an object list 34, which includes 
header entries 36 and a central directory 38, which pro- 
vbes a short-hand characterization of the header en- 
tries 36. 

3S [0023] An application program 40 stored in primary 
memory 28 Is executed by the central processing unit 
22. The appllcatbn program 40 Invokes objects 32 to 
perform specified functbns. The structure and features 
of the computer 70 discussed up to this point are con- 

40 sistent with the computer 20 of Rgure 1. However, the 
computer 70 of Figure 3 relies upon a different tech nique 
for bading objects. In particular, the primary memory 28 
of the computer 70 includes an Index generator 84, 
which Is used to produce a primary memory hashed in- 

45 dex object directory 86 that has a relatively small prima- 
ry memory footprint. As discussed bebw, the primary 
memory hashed index object directory 86 has a hash 
value for each object name. This hash value represents 
a substantially more compact representatbn of the ob- 

50 ject name. The primary menru>ry 28 also has an object 
bader 88. The object loader 88 processes the hashed 
index object directory 86 to selectively load objects that 
are vMzed by the app\\ca1ior\ program 40. Figure 3 also 
illustrates selected objects 90, whbh were loaded in re- 

55 liance upon the primary memory hashed index object 
directory 86 of the Invention. 

[0024] The primary memory hashed index object di- 
rectory 86 of the inventbn has a primary memory foot- 
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print that Is approximately one quarter of the primary 
memory footprint associated with a primary memory ob- 
ject index 42 of the prior art The invention has been 
intplemented to reduce the primary memory footprint of 
the JDK ZIP file frc^m approximately 424 KB to approx- 
imately 100 KB. Those skilled in the art will appreciate 
the importance of this savings of space In primary mem- 
ory 28, especially In the case of relatively small applica- 
tions mnning on relatively small platforms. The tech- 
nique of the invention will become increasing important 
as the size of object lists, such as In the JDK, increase. 
The invention is successfully exploited in connection 
with large JAR files in which only a fraction of the entries 
are used. 

[0025] The general nature and advantages of the In- 
vention have now been described. Attention presently 
turns to a more particular discussion of the invention. 
Rgure 4 illustrates processing steps associated with an 
Index generator 84 of the invention. The first processing 
step associated with the Index generator 84 Is to create 
a hash value and corresponding object location value 
for each object In a central directory (step 1 00). In other 
words, the Index generator scans a central directory 38 
of an object list 34. Each object name 50 of the object 
list 34 Is converted to a hash value. As known In the art, 
a hash functk>n produces a hash value. A hash functton 
partitions the domain of a functton into k sections, with 
each sectton being associated with an index. Any 
number of well known hash functtons may be used to 
produce a hash value of an object name 50 in accord- 
ance with the inventton. After creating a hash value and 
a corresponding object kx^ation value for each object, 
the information Is ksaded Into primary memory to form a 
primary memory hashed index object directory (step 
102). 

[0026] Rgure 5 illustrates a primary memory hashed 
index object directory 86 In accordance with an embod- 
iment of the inventk)n. The primary memory hashed in- 
dex object directory 86 Includes a set of hashed index 
entries 108A-108N. Each hashed index entry 108 in- 
cludes a hashed value 104, which corresponds to an 
object name 50. Each hashed value 104 also has a 
pointer or a similar feature that provides directton toward 
more comprehensive irrformation for the object 
[0027] Once the hashed Index object directory 86 Is 
loaded into primary memory, the object loader 88 can 
rely upon it to load selected objects 90. Figure 6 illus- 
trates processing steps associated with an object loader 
88 of the inventton. The first processing step associated 
with the object toader 88 is to derive a cakxjiated hash 
value for an Invoked object (step 110). The calculated 
hash value Is then matched to an entry In the primary 
memory hashed Index object directory (step 112). After 
a hash match is kientified, additional object parameter 
information Is used to confirm the object corresponding 
to the hashed value is actually the Invoked object (step 
1 1 4). Thus, for example, the pointer 1 06 associated wrth 
each hashed value 1 04 may t>e used to kientify header 
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Information 52B that can be used to confimi that the ap- 
propriate object has been selected. In the relatively rare 
case that a parameter match does not exist, processing 
returns to step 112, where a new hash match is Identi- 
5 fied. 

[0028] When the object parameter match operation 
(step 114) is satisfied, the appropriate hashed value for 
the Invoked object has been kjentified. In this case, the 
pointer 106 associated with the hashed value 104 is 
10 used to access the invoked object and load It into pri- 
mary memory (step 116). 

[00^ The inventton has t>een implemented with a 32 
bit hash function. False hits on the 32 bit hash code have 
been rare. White it is possible to occasionally have a 
15 false hit, this is not a performance problem in practk^. 
Even in the case of a false hit the proper object is found 
through the object parameter matohing operatk>n of step 
114. Surprising, the object parameter matching opera- 
tion of step 114 does not result in performance degra- 
de datk>n stemming from an extra read operatton to the 
header entry 36. The reason for this is that for the com- 
mon cases, the technique of the invention does the 
same numt)er of reads as the prtor art approach. In the 
prk>r art, the central directory 38 gives a pointer to the 
25 start of each header 52. The headers 52 are variable 
length. Therefore, the prtor art code must determine the 
header length and thus the actual start point of the rel- 
evant header Information. 

[0030] The Invention operates more efficiently when 
30 the hashed Index object directory 86 includes a cache 
cell to store the most recentiy referenced hashed value 
104 and associated pointer 106. Preferably, the object 
k}ader 88 Initially searches the cache cell to identify a 
hash matoh (step 112). Object parameters are then 
35 checked (step 1 1 4) and the object Is loaded (step 1 1 6). 
In practice, the cache cell of the hashed Index object 
directory 86 realizes a relatively high hit rate. 
[0031] Rgure 7 Illustrates an alternate apparatus 1 20 
for practicing the inventk>n. Figure 7 corresponds to Fig- 
40 ure 3, but Includes a storage device 1 21 , a communica- 
tions interface circuit 1 22, a network link 1 24. and a net- 
work 126. The programs stored In the primary memory 
28 and secondary memory 30 may be downtoaded from 
a computer readable medium associated with the stor- 
es age device 121, or attematety. rnay t>e executed from 
the computer-readable medium associated with the 
storage device 121. The term "computer readable me- 
dium" refers to any medium that partk:ipates In providing 
instructfons to the processor 22 for executton. Such a 
50 nDedium may take many forms, including but not limited 
to non-volatile media, volatile media, and transmission 
media. Non-volatile media includes, for example, opfical 
or magnetic disks, associated with the storage device 
121. Volatile media includes dynamic memory. Trans- 
55 misson media includes coaxial cables, copper wire and 
fiber optics, including the wires that comprise bus 26. 
Transmission media can also take the form of acoustic 
or light waves, such as those generated during radio- 
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wave and infra-red data communications. 
[0032] Common forms of computer readable media 
include, for example, a floppy disk, a flexible disk, hard 
disk, magnetic tape, or any other magnetk: medium, a 
CD-ROM, any other optical medium, punchcards, pap- 5 
ertape, any other physical medium with patterns of 
holes, a RAM, a PROM, EPROM, a FLASH-EPROM. 
any other memory chip or cartridge, a carrier wave as 
described bebw, or any other medium from whteh a 
computer can read. to 
[0033] Various forms of computer readable media 
may be invoh^ed in carrying one or more sequences of 
one or more instructtons to processor 22 for execution. 
For example, the instructbns may Initially be carried on 
a magnetic disk of a remote computer. The remote com- is 
puter can k>ad the Instructions Into Its dynamic memory 
and send the instructions over a telephone line using a 
modem. A modem local to the computer system 1 20 can 
receive the data on the telephone line and use an infra- 
red transmitter to convert the data to an infra-red signal. 20 
An infra-red detector coupled to the bus 26 can receive 
the data carried In the infra-red signal and place the data 
on bus 26. The bus 26 then carries the data to primary 
memory 28 or secondary memory 30, from which the 
processor 22 retrieves and executes the instructions. 25 
The instructions may optionally be stored on the storage 
device 121 either before or after execution by the proc- 
essor 22. 

[0034] The computer system 120 also Incfcjdes a 
communication interface circuit 1 22 coupled to the bus 30 
26. The communk:ation interface circuit 122 provkles a 
two-way data comnrunlcatlon coupled to a network link 
124 that is connected to a network 126. For example, 
the communication Interface circuit 122 may be an Inte- 
grated services digital network (ISDN) card or a modem 35 
to provide a data communicatfon connection I0 a corre- 
sponding type of telephone line. As another example, 
the communk^ation Interface circuit 122 may be a local 
area network (LAN) card to provide a data communica- 
tion connection to a compatible LAN. Wireless finks may 4o 
also be Implemented. In any such implementation, the 
communicatton interface circuit 122 sends and receives 
electrical, electromagnets or optical signals that carry 
digital data streams representing various types of infor- 
matkdn. 45 
[0035} The network link 124 typteally provides data 
communteation through one or more networks, repre- 
sented by the network 126. For example, the network 
link 1 24 may provide a connectton to a network 1 26 that 
Includes a host computer operated as an Internet Serv- 50 
ice Provider (ISP). The ISP in tum provides data com- 
munication services through the world wide packet data 
communication network now commonly referred to as 
the "Interner. The network 126 uses electrical, electro- 
magnetic or optical signals that carry digital data ss 
streams. The signals through the various networks and 
the signals on the networic link 1 24 and through the com- 
munication interface circuit 122, which carry the digital 



data to and from the computer system 120, are exem- 
plary forms of carrier waves transporting the informa- 
tion. 

[0036] The computer system 1 20 can send messages 
and receive data, including program code, through the 
network 126, the networic link 124, and the communfea- 
tion interface circuit 1 22. In the Internet example, a sew- 
er on the networic 126 may transmit a requested code 
for an application program through the networic 1 26, the 
network fink 124. and the comnmjnicatton interface cir- 
cuit 122. The received code may be executed by the 
processor 22 as It Is received and/or stored in the stor- 
age device 1 21 , or other non-volatile storage for subse- 
quent execution. In this manner, the computer system 
120 may obtain applk:ation code in the form of a carrier 
wave. 

[0037] The foregoing description, for purposes of ex- 
planation, used specific nomenclature to provide a thor- 
ough understanding of the Invention. However, it will be 
apparent to one skilled in the art that the specific details 
are not required In order to practice the invention. In oth- 
er instances, well known circuits and devices are shown 
in block diagram form in order to avokJ unnecessary dis- 
traction from the underlying inventton. Thus, the forego- 
ing descriptions of specific embodiments of the present 
Invention are presented for purposes of lllustratton and 
descrlptton. They are not Intended to be exhaustive or 
to limit the inventkjn to the precise forms disclosed, ob- 
viously many modifications and variattons are possible 
In view of the above teachings. The embodiments were 
chosen and described In order to best explain the prin- 
ciples of the invention and its practteal applfcations. to 
thereby enable others skilled in the art to best utilize the 
invention and various embodiments with various modi- 
fications as are suited to the particular use contemplat- 
ed. It Is intended that tiie scope of the inventton be de- 
fined by the following claims and their equivalents. 

Claims 

1- A method of toading software objects from primary 
memory, said method comprising the steps of: 

creating a hash value for a listed object; 
combining said hash value with a listed object 
locatton value; 

repeating said creating step and said combin- 
ing step to create a hash Index specifying a plu- 
rality of hash values and corresponding listed 
object tocatton values; 

toading said hash index into primary memory to 
form a primary memory hashed index object di- 
rectory; 

deriving a calculated hash value for an invoked 
object; 

matching said calculated hash value with a 
hash value In said primary memory hashed in- 
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dex object directory; and 
loading an object corresponding to said calcu- 
lated hash value in response to said matching 
step. 

2. The method of daim 1 wherein said creating step 
Includes the step of creating a hash value for a listed 
object In a central directory listing objects. 

3. The method of daim 2 wherein said creating step 
Includes the step of creating a hash value for a fisted 
object in a central directory of a JAVA language ZIP 
format file. 

4. The method of daim 3 wherein said creating step 
includes the step of creating a hash value for a Rsted 
object in a central directory of a JAVA Archive forniat 
file. 

5. The method of claim 1 wherein said matching step 
includes the steps of: 

comparing said calculated hash value to hash 
values in said primary memory hashed index 
object directory to identify a hash match be- 
tween said calculated hash value and a listed 
object hash value associated with a target ob- 
ject; and 

conflnning that object parameter Infonnation 
for said Invoked object matches object param- 
eter Infonmation for said target objecL 

6. The method of claim 1 wherein said matching step 
Includes the steps of: 

comparing said calculated hash value to hash 
values in said primary memory hashed index 
object directory to identify a hash match be- 
tween said calculated hash value and a listed 
object hash value associated with a target ob- 
ject; 

Identifying when object parameter Information 
for said Invoked object does not match object 
parameter infonnation for said target object; 
and 

repeating said comparing step in response to 
said identifying step. 

7. The method of claim 1 wherein said matching step 
Includes the step of matehlng said calculated hash 
value with a hash value in a cache cell of said pri- 
mary memory hashed index object directory. 

8. A computer readable medium to coordinate ttie 
loading of objects from primary memory, compris- 
ing: 

an index generator with executable instructions in- 
cluding 



a first module to create a hash value for a fisted 
object, 

a second module to combine said hash value 
with a listed object location value, 

5 a third module to invoke said first module and 

said second module to create a hash index 
specifying a plurality of hash values and con'e- 
spondlng listed object tocatlon values, and 
afourth module to load said hash index into pri- 

10 mary memory to form a primary memory 

hashed index object directory; and an object 
loader with executable Instructfons Including 
a fiftti module to derive a calculated hash value 
for an Invoked object; 

IS a sixtii module to mateh said calculated hash 

value with a hash value in said primary memory 
hashed index object directory; and 
a seventh module to toad an object correspond- 
ing to said calculated hash value in response 

20 to said matching step. 

9. The apparatus of claim 8 wherein sakJ first module 
includes executable instructions to create a hash 
value for a listed object in a central directory fisting 

25 objects. 

10. The apparatus of claim 9 wherein sakJ first module 
includes executable instructions to create a hash 
value for a fisted object in a central directory of a 

30 JAVA language ZIP formal file. 

11. The apparatus of daim 1 0 wherein said first module 
Includes executable instructions to create a hash 
value for a fisted object in a central directory of a 

35 JAVA Archive format file. 

1 2. The apparatus of claim 8 wherein said sixth module 
includes executable Instructtons to: 

4o compare saW calculated hash value to hash 

values In said primary memory hashed index 
object directory to kJentify a hash match be- 
tween said calculated hash value and a fisted 
object hash value associated with a target ob- 

45 ject; and 

confirm that object parameter information for 
said Invoked object matehes object parameter 
information for said target object. 

50 13. The apparatos of daim 8 wherein said sixth module 
Includes executable instructtons to: 



compare said cateulated hash vaJue to hash 
values in said primary memory hashed index 
55 object directory to identify a hash match be- 

tween said calculated hash value and a fisted 
object hash value associated with a target ob- 
ject; 
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Identify when object parameter Information for 
said Invoked object does not match object pa- 
rameter Information for said target object; and 
repeat said compare operation in response to 
the identify operation. s 

14. The apparatus of claim 8 wherein said sixth module 
includes executable instructions to match said cal- 
culated hash value with a hash value stored In a 
cache cell of said primary memory hashed index ob- io 
Ject directory. 
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